home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / oz111.zip / MANUAL < prev    next >
Text File  |  1992-09-19  |  60KB  |  1,380 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                       An Ounce Of Prevention (tm)
  8.  
  9.                File Protection and Recovery System for DOS
  10.  
  11.  
  12.  
  13.                            User Manual 1.11
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                        Pete Maclean Software
  22.                          P. O. Box 591359
  23.                    San Francisco, CA  94159-1359
  24.  
  25. An Ounce Of Prevention, software and user manual, are Copyright 1991-92 Pete 
  26. Maclean.  All rights reserved.  An Ounce Of Prevention is a trademark of Pete 
  27. Maclean.  Other product names mentioned in this manual are trademarks of their 
  28. respective vendors.
  29.  
  30.  
  31.  
  32. Acknowledgments
  33. ---------------
  34. An Ounce Of Prevention was designed by Pete Maclean and Stan Brin from an idea 
  35. by Stan Brin.  The programs were written by Pete Maclean.  The manual was 
  36. written by Stan Brin and Pete Maclean.
  37.  
  38. Thanks are due to Joann, Bill, David, Peter and Ken.
  39.  
  40. Special thanks are due to Nick Hammond of FBN Software.
  41.  
  42.  
  43.  
  44. About The Author
  45. ----- --- ------
  46. Pete Maclean is an expert in computer networking, and also dabbles in utilities, 
  47. operating systems and other areas.  He is known for his PC Magazine utilities 
  48. Emma and Pandora, and is currently a contributing editor to Network Computing 
  49. magazine.  A native of Scotland, Mr. Maclean is a long time resident of San 
  50. Francisco, where he works as a network consultant, writer and independent 
  51. software developer.
  52.  
  53.                           Table Of Contents
  54.                           ===== == ========
  55.  
  56.  
  57.                                                           Page
  58. Introduction
  59.      Why you need An Ounce Of Prevention . . . . . . . . . . 4
  60.      What An Ounce Of Prevention does for you. . . . . . . . 5
  61.      List of files . . . . . . . . . . . . . . . . . . . . . 6
  62.      What you need to run this software. . . . . . . . . . . 7
  63.  
  64. Chapter 1:  What An Ounce Of Prevention Does . . . . . . . . 8
  65.  
  66. Chapter 2:  Using the Install Program. . . . . . . . . . . .11
  67.  
  68. Chapter 3:  Installing The Program By Hand . . . . . . . . .13
  69.  
  70. Chapter 4:  OzUtil:  The Oz Utility Program. . . . . . . . .16
  71.  
  72. Chapter 5:  When Your Disk Fills Up. . . . . . . . . . . . .19
  73.  
  74. Chapter 6:  Handling DOS Critical Errors . . . . . . . . . .24
  75.  
  76. Appendix A:  OzRes Error Messages. . . . . . . . . . . . . .26
  77.  
  78. Appendix B:  Technical Notes . . . . . . . . . . . . . . . .28
  79.  
  80. Appendix C:  Support . . . . . . . . . . . . . . . . . . . .30
  81.  
  82. Appendix D:  Shareware . . . . . . . . . . . . . . . . . . .31
  83.  
  84.  
  85.                              Introduction
  86.                              ============
  87.  
  88. Why You Need An Ounce Of Prevention:  A True Story
  89. === === ==== == ===== == ===========  = ==== =====
  90.  
  91. Early in 1987, one of the designers of An Ounce Of Prevention suffered repeated 
  92. hard disk disasters.  In one case, he accidentally erased several dozen very 
  93. important documents and was unable to recover most of them because the products 
  94. available at the time could not retrieve erased files consistently.  This person 
  95. learned a lot about hard disks during that period:
  96.  
  97. Hard disks are very reliable until the slightest thing goes wrong.
  98.  
  99.      Popular utility programs such as The Norton Utilities, PC Tools,
  100.      and Mace, emphasize curing file problems after they happen,
  101.      rather than preventing their occurring in the first place.
  102.      And afterwards is often too late.
  103.  
  104.      And even though those other programs can sometimes resurrect deleted 
  105.      files, they can never restore overwritten files, such as spreadsheets.
  106.  
  107. Operating under the adage that "an ounce of prevention is worth a pound of 
  108. cure," we thought that there must be a way to insure programs and data against 
  109. loss before disasters occur.
  110.  
  111. Thus was born An Ounce Of Prevention, the program that prevents data loss.
  112.  
  113. Since it would be unwieldy to use the product's full name at every mention, 
  114. we'll generally refer to it using the standard abbreviation for an ounce, Oz.
  115.  
  116. What An Ounce Of Prevention Does For You
  117. ---- -- ----- -- ---------- ---- --- ---
  118. Oz offers several levels of data protection:
  119.  
  120.      File Security - Oz automatically preserves deleted files so that
  121.      they may be instantly restored if needed.  Up to eight generations
  122.      of each deleted file can be preserved, all under the same name.
  123.  
  124.      Reformat Trapping - Oz prevents accidental or malicious attempts
  125.      to reformat a hard disk.
  126.  
  127.      Write Protection - Oz allows you to write-protect a disk if you
  128.      suspect the presence of a virus, or other rogue program, that might
  129.      try to damage your system.
  130.  
  131.      Full-Disk Protection - Oz traps "full disk" conditions and offers
  132.      you a helpful set of options to free some space for your work. 
  133.  
  134.      Critical Error Handling - Oz recognizes a number of critical disk
  135.      errors, tells you what is wrong, and offers a range of options for
  136.      dealing with them.
  137.  
  138.  
  139. Note to Novice Users
  140. ---- -- ------ -----
  141. It is not necessary to be a programmer or even a "power user" to install and use 
  142. Oz.  It is advisable, however, for you to be familiar with certain basic MS-DOS 
  143. principles and techniques such as:
  144.  
  145.      Copying and renaming files.
  146.      Creating directories and sub-directories.
  147.      Changing drives and directories.
  148.      Creating and changing batch files.
  149.  
  150. File List
  151. ---- ----
  152. An Ounce Of Prevention includes the following files:
  153.  
  154. OZRES.EXE    An 14KB memory-resident program that preserves files, traps disk
  155.              formats, and pops up when you run out of diskspace.
  156.  
  157. OZUTIL.EXE   The Oz utility program which restores files preserved by OzRes and
  158.              performs various other related tasks.
  159.  
  160. INSTALL.EXE  The Oz installer.  Copies the Oz system to a directory of your
  161.              choice, optionally edits your AUTOEXEC.BAT, and configures Oz
  162.              to protect your system according to your specifications. 
  163.  
  164. README.EXE   A simple browser program for reading documentation files.
  165.  
  166. MANUAL       The Oz User Guide that you are now reading.
  167.  
  168. STARTER      A one-page quick-start guide for users who hate to read manuals.
  169.  
  170. LICENSE      The Software License Agreement for unregistered users.  Please
  171.              read this before using the software.
  172.  
  173. REGISTER     Instructions for registering your copy of Oz.
  174.  
  175. ORDER.FRM    An order form for registering your copy of Oz.
  176.  
  177. VENDOR.DOC   Special information for diskette vendors, BBS sysops, and other
  178.              businesses that distribute shareware.
  179.  
  180. What An Ounce Of Prevention Needs
  181. ---- -- ----- -- ---------- -----
  182. Compatible Computers - Oz has been tested on a large number of systems including 
  183. PCs, ATs, and PS/2s.  It should be compatible with any IBM PC or compatible 
  184. computer running DOS 2.1 or higher (except ROM-resident versions such as DOS 
  185. 3.22).
  186.  
  187. Compatible Graphics Adapters - OzRes, the Oz resident program, may not properly 
  188. restore certain EGA and Hercules graphics screens after it "pops-up."  This 
  189. results from limitations in the design of these video adapters and not from any 
  190. fault in Oz.
  191.  
  192. Hard Disks - Although we have not found any, it is possible that Oz may have 
  193. some difficulties with a few hard disks that have non-standard drivers.  If you 
  194. have doubts about your system, we recommend that you back up your drive before 
  195. installing Oz, just to be sure.
  196.  
  197. Memory Requirements - OzRes, the memory-resident portion of Oz, permanently 
  198. occupies about 14K of RAM.  With the aid of memory-management products such as 
  199. QEMM 386, it can be loaded into high memory.
  200.  
  201. TSR Compatibility - OzRes should be compatible with other terminate-and-stay- 
  202. resident programs, such as SideKick or Gopher, because, unlike most, it does not 
  203. have to watch the keyboard for a signal to "pop-up."  The only TSR program known 
  204. to be incompatible with Oz is Lotus Express.
  205.  
  206. Stacker - Oz is compatible with Stacker version 2.0.  Oz will protect files and 
  207. do everything it normally does on a Stacker drive except for providing reformat 
  208. protection.  Oz will probably not work with other disk-compression systems.
  209.  
  210. Should you experience a compatibility problem, such as a system freeze, you can 
  211. probably prevent a recurrence by changing the order in which your TSRs are 
  212. loaded.  If possible, OzRes should be loaded first, before any other TSRs.
  213.  
  214.                               Chapter 1
  215.                    What An Ounce Of Prevention Does
  216.                    ==== == ===== == ========== ====
  217.  
  218. Oz protects your data by preserving deleted and overwritten files so that you 
  219. can recover them.  Provided that you have some unused disk space, this function 
  220. is far more powerful than that provided by "unerase" programs such as those 
  221. found in Norton Utilities or PC Tools.
  222.  
  223. Oz also performs other valuable tasks related to disk and file safety,
  224. including:
  225.  
  226.      Protection against attempts to format your hard disk(s).
  227.  
  228.      Optional protection against all attempts to write to a hard disk.
  229.  
  230.      Trapping critical DOS errors, providing additional information
  231.      about them, and more power to recover from them.
  232.  
  233.  
  234. Preserving Deleted Files
  235. ---------- ------- -----
  236. Oz's primary purpose is to preserve deleted files. 
  237.  
  238. When Oz is installed in your PC, something special happens whenever an attempt 
  239. is made to delete a file:  Oz hides it.  You do not see these "Oz-deleted" files 
  240. on directory listings, and you can create new files with the same names.  If 
  241. fact, the only obvious evidence you can see that such files still exist is that 
  242. they continue to occupy disk space.
  243.  
  244. But they are still there for you, and Oz can instantly restore them, at your 
  245. command. 
  246.  
  247. When an application program updates a data file, it may do so in one of two 
  248. ways:
  249.  
  250. (1).  The program can delete the existing version of the data file and then 
  251. create a new one with the same name.  Many such applications also create a 
  252. backup copy, often on a file with the extension .BAK.
  253.  
  254. (2).  The program may overwrite the old file with the updated data.  Many 
  255. spreadsheet programs, including Lotus 1-2-3, work in this fashion.
  256.  
  257. Oz preserves files that you delete by means of DOS' DEL or ERASE command, and 
  258. also files that are deleted internally by programs.  Oz does not, however, 
  259. preserve copies of files that are overwritten when changes are made to them.  We 
  260. wish that Oz could protect those overwritten files for you too but there is, 
  261. unfortunately, no way for it to accomplish that in a reliable and efficient 
  262. manner.
  263.  
  264.  
  265. Multiple Generations
  266. -------- -----------
  267. Oz preserves not only the last version of a deleted file, but up to eight 
  268. generations.  Each time a file is deleted and recreated, a new preserved file is 
  269. created, but previous generations remain available, just in case.
  270.  
  271. Imagine a stack of paper files:  Each time you add or change something, a new 
  272. copy of the file is added to the top of the stack while the oldest generation 
  273. drops off the bottom.
  274.  
  275. It is, in practice, unlikely that you will ever need to retrieve a file that is 
  276. eight generations old, so Oz allows you to limit the number of generations that 
  277. it will protect for you.  The default is two generations.
  278.  
  279.  
  280. Making Use of "Unused" Disk Space
  281. ------ --- -- -------- ---- -----
  282. Oz maximizes the value of that portion of your disk space not occupied by active 
  283. files.  Without Oz, unused disk space fills with bits and pieces of deleted 
  284. files that can never be used again.
  285.  
  286. Some of the data in that unused area could be extremely valuable especially in 
  287. an emergency but, without Oz, it is completely disorganized and is gradually 
  288. overwritten and permanently lost.
  289.  
  290. Without Oz, if you need to unerase a lost file you have to search for each piece 
  291. of it.  You may find pieces missing as space gets overwritten; and you may have 
  292. a lot of trouble distinguishing pieces left over from various different versions 
  293. of the file.
  294.  
  295. Oz, then, performs a unique service.  It allows you to take full advantage of 
  296. every single megabyte of disk that you buy, not just the portion that contains 
  297. your active files.  (Nevertheless, there is no truth to the rumor that Oz is the 
  298. result of a conspiracy by disk manufacturers to get you to buy more and larger 
  299. drives.)
  300.  
  301.  
  302. What Happens When Your Disk Fills Up?
  303. ---- ------- ---- ---- ---- ----- ---
  304. Whenever DOS runs out of space on the disk to store new files, Oz produces a box 
  305. on your screen giving you various options for handling the situation, including 
  306. that of discarding older generations of Oz-deleted files.
  307.  
  308.  
  309. Other Protection Facilities Provided by Oz
  310. ----- ---------- ---------- -------- -- --
  311. Write Protection - Oz can protect your existing programs and data by "write- 
  312. protecting" your disk.  This temporarily prevents software from changing 
  313. anything, and allows you to test software without risking the introduction of a 
  314. dangerous "Trojan Horse" program that might destroy your files.
  315.  
  316. Write-protection can also protect sensitive files that may be damaged by 
  317. inexperienced users.
  318.  
  319. Write-protection is easily set and removed by using the Oz utility program 
  320. described in Chapter 4.
  321.  
  322.      Note:  Oz's write protection is the strongest that can be
  323.      enforced by software, but it is not perfect.  Only special
  324.      hardware devices can provide absolute protection against
  325.      destructive write operations to a disk.
  326.  
  327. Preventing Hard Disk Formats - When the Oz resident program is active, it 
  328. constantly watches your system for any attempt to format any Oz-protected disk.
  329.  
  330. When Oz intercepts any action that might signify a format operation, it 
  331. immediately write-protects the disk.  A virus or a software bug will then find 
  332. it very difficult to cause any damage.
  333.  
  334. This procedure is somewhat draconian -- your work will immediately stop until 
  335. you tell the Oz utility program to cancel write-protection (see Chapter 4).  But 
  336. your disk and the data on it will be safe.
  337.  
  338.      Note:  If you deliberately intend to reformat a hard disk,
  339.      you must unload OzRes.  An option in the Oz utility program,
  340.      can do this for you.
  341.  
  342. Trapping Critical Disk Errors - When DOS detects a potentially fatal error, it 
  343. normally reacts by interrupting your work with a cryptic message that may cause 
  344. your system to crash, for example:
  345.  
  346.               Not ready error reading drive A:
  347.               Abort, Retry or Ignore?
  348.  
  349. Oz suppresses these messages and instead displays a dialogue box that explains 
  350. the problem and what can be done about it.  And Oz does this for errors on all 
  351. disk volumes, not just Oz-protected drives.
  352.  
  353.  
  354. Remember to Backup!
  355. -------- -- -------
  356. While Oz can prevent many potentially disastrous losses of data and programs, it 
  357. is not a substitute for regular backups -- there are simply too many possible 
  358. catastrophes that are beyond the capabilities of software alone.  These include:
  359.  
  360.      Bad disk sectors
  361.      Hard disk errors (bad media, controller cards, etc.)
  362.      Power surges or spikes
  363.      Malicious destruction of files
  364.      Fire, theft, and acts of nature
  365.  
  366. Believe us when we tell you:  Backup your important files and store the backups 
  367. in a secure place.
  368.  
  369.                              Chapter 2
  370.                      Using the Install Program
  371.                      ===== === ======= =======
  372.  
  373. With most programs, installation is a secondary task.  One copies the files, and 
  374. that's it.
  375.  
  376. With Oz, however, installation is of prime importance because most of its 
  377. functions occur automatically in the background while you do your regular work.  
  378. Unless you take some time and care to install Oz properly, it will not give you 
  379. the best protection possible.
  380.  
  381. Installing Oz is Easy - Once Oz is installed, you can forget about it.  Until, 
  382. that is, you accidentally delete an essential file.  Then you will be glad you 
  383. took the time and trouble.
  384.  
  385. Guided Tour - Once you have installed Oz, you can get a guided tour of its 
  386. protection mechanisms by selecting the Demo option from the menu of the Oz 
  387. utility program.
  388.  
  389.  
  390. The Oz Installer
  391. --- -- ---------
  392. INSTALL.EXE is an interactive, self-documenting program that asks a set of 
  393. questions to determine how you want Oz installed.  As you answer these 
  394. questions, the Installer does the following:
  395.  
  396.      Copies the Oz files to an existing directory, or creates a new one.
  397.  
  398.      Adds, if you desire, a customized command line to your
  399.      AUTOEXEC.BAT file (or AUTOUSER.BAT for users IBM's PC LAN
  400.      Program) that automatically loads the resident OzRes program
  401.      each time you start DOS. 
  402.  
  403.  
  404. Installing From Diskette
  405. ---------- ---- --------
  406. If you have Oz supplied on a diskette, then insert the Oz diskette into your A: 
  407. drive and, at the DOS prompt, enter:
  408.  
  409.               a:install         
  410.  
  411. You may, alternatively, install Oz from your B: drive.  Just type:
  412.  
  413.               b:install
  414.  
  415.  
  416. Installing From a Hard Disk
  417. ---------- ---- - ---- ----
  418. If you have downloaded Oz from a BBS or have otherwise obtained the distribution 
  419. package on a hard drive then, while in the directory where the Oz files are, 
  420. type:
  421.  
  422.               install
  423.  
  424.  
  425. Using The Installer
  426. ----- --- ---------
  427. When you start the Installer you see an introductory screen welcoming you to An 
  428. Ounce Of Prevention.  The animated logo, in case you don't recognize it, 
  429. represents the silhouette of a spinning disk drive with its heads moving 
  430. randomly from track to track.
  431.  
  432.      Press [Space] to clear the Oz logo from the screen.
  433.  
  434. The logo disappears and the Installer asks you a set of detailed questions about 
  435. what you want Oz to do for you:
  436.  
  437.      Where to place the Oz files
  438.      The number of generations of files to protect
  439.      The drives or volumes to protect
  440.      Whether or not you wish to protect archived files
  441.      Certain file types that you do not wish to protect
  442.  
  443. As you answer these questions, the Installer displays your choices at the top of 
  444. the screen.
  445.  
  446. Press [Space] to pass through the help screens, or [Esc] at any time within the 
  447. program to completely cancel the installation.  If you change your mind at any 
  448. point about the selections you have made, don't worry; the last question asked 
  449. by the Installer allows you to cancel everything and start again.
  450.  
  451.      Note:  The Installer does not copy INSTALL.EXE to the Oz
  452.      directory.  There is normally no need to have it there so
  453.      why waste the space.
  454.  
  455.  
  456. Changing the Installation
  457. -------- --- ------------
  458. If you make a mistake or wish to reconfigure your Oz installation, you can run 
  459. the Oz Installer again.  But it's usually easier to delete or modeify an Oz 
  460. command line manually with an ASCII editor or word processor following the 
  461. guidelines in the next chapter.
  462.  
  463.  
  464. Loading Order
  465. ------- -----
  466. The Installer leaves you to choose where in the AUTOEXEC.BAT file it should 
  467. place the command to load the memory-resident part of Oz.  If you later discover 
  468. that other memory-resident software is sensitive to loading order, you may wish 
  469. to use an editor to move the command line to another position in the file.
  470.  
  471.                                Chapter 3
  472.                          Installing Oz By Hand
  473.                       (For Experienced DOS Users)
  474.                       ==== =========== === ======
  475.  
  476. The previous chapter showed you how to install Oz using the Install program.
  477.  
  478. While the Installer may be useful to first time users of Oz, experienced users 
  479. may prefer to install Oz "by hand," that is with the use of the DOS COPY command 
  480. and a text editor.
  481.  
  482. This method is also the best way to modify an existing Oz installation.
  483.  
  484.  
  485. Copying Oz
  486. ------- --
  487. Oz comprises only a few files, all which can be copied into a directory of your 
  488. choice, typically called "\OZ".  To copy these files from a distribution disk in 
  489. A: drive, enter:
  490.  
  491.               C>md \oz
  492.               C>cd \oz
  493.               C>copy a:*.*
  494.  
  495.      Note:  Oz does not require that its files reside in a
  496.      specific directory.  It is however a good idea to keep it
  497.      in a directory with a self-explanatory name, such as "\OZ".
  498.  
  499. Pathing to Oz - You should include the Oz directory in your DOS PATH statement.  
  500. This will allow you to run Oz from any directory.  Or, even better, move 
  501. OZUTIL.EXE into a directory that already appears in your path.
  502.  
  503.  
  504. The OzRes Command Line 
  505. --- ----- ------- ----
  506. Oz is installed into your system by the use of a special DOS command line that 
  507. loads OzRes - the memory-resident portion of Oz that stands guard over your data 
  508. - and tells it what you want it to do. 
  509.  
  510. This command line is normally placed in your AUTOEXEC.BAT file so that OzRes is 
  511. automatically loaded each time you start DOS.  You may also start OzRes by 
  512. entering a command line at the DOS prompt:
  513.  
  514.               ozres cd:  /1a *.$* TEMP.* *.QQQ *.bak *.prn *.chk
  515.  
  516. After the filename "ozres" in the above example are a number of "arguments."  
  517. These arguments are explained in the remainder of this chapter.
  518.  
  519.  
  520. The Oz-Protected Disks
  521. --- ------------ -----
  522. The first argument identifies the disks that Oz is to protect.  You may list any 
  523. number of DOS drive letters.  In our example, Oz is told to protect drives 
  524. C: and D:.
  525.  
  526.               ozres c:          <- OzRes must be provided with at least one
  527.                                    disk name or it will refuse to run!
  528.  
  529. The colon following the drive letters can be omitted but it's a good idea to 
  530. include it as it serves as a reminder of the argument's significance.
  531.  
  532. OzRes will protect hard-drive volumes only.  Floppy, RAM and network drives are 
  533. unacceptable.
  534.  
  535.  
  536. Program Options
  537. ------- -------
  538. Program Options are two optional characters on the OzRes command line that may 
  539. appear in an argument that begins with a slash:
  540.  
  541.               ozres c: /1a
  542.  
  543. The Program Options may appear after the slash in any order.  The above example 
  544. takes advantage of both options.
  545.  
  546. Generations - Oz will protect up to eight generations of files, discarding the 
  547. oldest file each time the maximum number is reached.  A numeral after the slash 
  548. character on the command line tells OzRes the number of generations that you 
  549. wish to keep.
  550.  
  551. The 1 below tells OzRes that you want it to protect a single generation of 
  552. deleted files:
  553.  
  554.               OZRES c:  /1      <- OzRes will protect just one generation.
  555.  
  556. A number between one and three is recommended to make the best use of disk 
  557. space.  If you do not provide a value, OzRes assumes a default value of two 
  558. generations.
  559.  
  560. Archive - It is wasteful to ask Oz to preserve files that have already been 
  561. backed-up - you already have safe copies of these.  The Archive Program Option 
  562. tells OzRes to ignore any file that has been backed-up; DOS then erases it in 
  563. the conventional way:
  564.  
  565.               ozres c:  /1a     <- The numeral "1" is optional 
  566.  
  567. OzRes uses a standard DOS technique to tell whether a file has been backed up:  
  568. the "archive attribute" maintained for each file.  DOS automatically turns on a 
  569. file's archive attribute whenever any write is performed to it.
  570.  
  571. If you do not specify the /a option, OzRes pays no attention to the archive 
  572. attribute.
  573.  
  574.      Note:  Not all backup programs turn off the archive
  575.      attribute.  If yours does not, you should not use the
  576.      Archive program option.  To find out, consult the backup
  577.      program's manual or use the MS-DOS utility "ATTRIB":
  578.  
  579.  
  580.               C>attrib filename   <- Checks a file called "filename"
  581.  
  582.  
  583. Exclusions 
  584. ----------
  585. All subsequent arguments on the OzRes command line identify files that you wish 
  586. to exclude from Oz's protection.  By excluding files that you would never want 
  587. to restore, Oz can make the best use of disk space for preserving those files 
  588. that you might need to undelete.
  589.  
  590. These exclusions are written on the command line as wildcard statements, as in 
  591. the example found on the previous page:
  592.  
  593.               ozres cd:  /4a *.$* TEMP.* *.QQQ *.bak *.prn *.chk
  594.  
  595. Temporary Application Files - DOS often creates temporary files having an 
  596. extension of .$$$.  There is nothing to be gained by preserving them.
  597.  
  598. Many programs create temporary files as they edit, sort, or print.  MS Word, for 
  599. example, creates files with extension .TMP.  WordStar creates temporary files 
  600. with extensions like .$A$ and .$B$.  To learn the filename conventions used by 
  601. your application software, check your manual for the specific naming convention, 
  602. or enter a "DOS Window" while the program is running and run a DIR listing.
  603.  
  604. Temporary Personal Files - You may customarily create temporary files of your 
  605. own to hold portions of documents or test data.  If you do this, give your 
  606. temporary files a standard style of name - TEMP.xxx or xxxxx.QQQ for example - 
  607. so that OzRes can be instructed to ignore them.
  608.  
  609. Backup Files - Other programs, such as WordStar, do not erase previous versions 
  610. of files, but rename them - LETTER.DOC becomes LETTER.BAK, for example - as soon 
  611. as a new version is saved to disk.  You may or may not wish to exclude such 
  612. files.
  613.  
  614. Note that this process preserves only one prior version of each file.  If you 
  615. want more than one generation to be preserved, do not include .BAK files in the 
  616. exclusion list.
  617.  
  618. Re-creatable Files - Many files can easily be recreated and would only waste 
  619. disk space if preserved by Oz.  Compilers, for example, produce object files 
  620. with the extension .OBJ.
  621.  
  622. Very Large Files -  Exclude databases and other big files when you have 
  623. insufficient diskspace to accommodate deleted versions of them.
  624.  
  625. Print Files - If you use any applications that write printable output to files 
  626. rather than directly to a printer then be sure to exclude those files.  Lotus
  627. 1-2-3, for example, creates print files with the extension .PRN.
  628.  
  629.      Tip:  Most files that you would want to exclude from Oz's
  630.      protection can be identified by a telltale extension.  It
  631.      is quite okay, however, to identify exclusions by other
  632.      patterns or by exact filenames.
  633.  
  634.                               Chapter 4
  635.                     OzUtil:  The Oz Utility Program
  636.                     =======  === == ======= =======
  637.  
  638.  
  639. Overview
  640. --------
  641. OzUtil is a menu-driven utility program that allows you to perform a number of 
  642. useful "housekeeping" chores, such as restoring Oz-deleted files.
  643.  
  644. To start OzUtil, at the DOS prompt enter:
  645.  
  646.               ozutil
  647.  
  648. You then see:
  649.  
  650. ┌──────────────────────────────────────────────────────────────────────────────┐
  651. ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ An Ounce Of Prevention ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  652. └┬────────────────────────────────────────────────────────────────────────────┬┘
  653.  │ OzRes is loaded and protecting disk C:                                     │ 
  654. ┌┴────────────────────────────────────────────────────────────────────────────┴┐
  655. │                                                                              │
  656. │                                                                              │
  657. │                                                                              │
  658. │                                                                              │
  659. │                                                                              │
  660. │               ■ Restore Oz-deleted files                                     │
  661. │               ■ Demonstrate An Ounce Of Prevention                           │
  662. │               ■ Information about An Ounce Of Prevention                     │
  663. │               ■ Purge Oz-deleted files to free disk space                    │
  664. │               ■ Toggle write-protection on the Oz-protected disk             │
  665. │               ■ Unload Oz-resident program from memory                       │
  666. │               ■ Quit                                                         │
  667. │                                                                              │
  668. │                                                                              │
  669. │                                                                              │
  670. │                                                                              │
  671. │                                                                              │
  672. │                                                                              │
  673. └──────────────────────────────────────────────────────────────────────────────┘
  674.   
  675. The line below the program name is the status line, which tells you whether or 
  676. not OzRes, the Oz-resident program, is in memory.  If OzRes is active, the 
  677. status line identifies the volumes it is protecting. 
  678.  
  679. The main panel of the display contains a menu of the program's functions.  Use 
  680. the cursor keys to navigate through the options and select an option by pressing 
  681. [Enter].  Alternatively you may simply press the initial letter of a menu entry.  
  682. You can leave OzUtil by selecting the "Quit" option - or by pressing [Esc].
  683.  
  684.  
  685. Restore Oz-deleted Files
  686. ------- ---------- -----
  687. This feature allows you to retrieve up to eight previous generations of files 
  688. deleted on a protected disk, depending on the number of generations that you 
  689. instruct OzRes to preserve.
  690.  
  691. To restore Oz-deleted files, select the "Restore Oz-deleted files" option from 
  692. the main OzUtil menu.  OzUtil displays an alphabetized list of all Oz-protected 
  693. files in the current directory, and the number of versions available of each.
  694.  
  695.                        Number of deleted
  696.               Filename     versions
  697.               AUTOEXEC.BAT    2
  698.               BWPRINT.C       1
  699.               BWLOCK.C        3
  700.               PIX             1
  701.               X.BAT           1
  702.  
  703.      Move the menu bar to select the file to be restored.
  704.      (You can restore any number of preserved files but must
  705.      do so one at a time.)
  706.  
  707. If there is more than one version of the file, OzUtil displays a menu of the Oz- 
  708. protected versions in numeric order, oldest first:
  709.  
  710.               Version
  711.               number     Directory entry
  712.                  1    AUTOEXEC.BAT          128  90/02/25  06:29 PM
  713.                  0    AUTOEXEC.BAT          128  90/02/25  06:29 PM
  714.  
  715. This menu includes the version number, file name, size, date, and time of each 
  716. deleted file of the same name, helping you to pick the exact file that you want 
  717. to restore.  As on any normal directory listing, the date and time note when the 
  718. file was last changed, not when it was deleted.
  719.  
  720.      Move the menu bar to choose the desired file or press [Esc].
  721.  
  722. OzUtil asks you to confirm your choice:
  723.  
  724.               Target file for undeletion is:
  725.  
  726.                    BWNFSD.C           28,175  89/09/26  12:47 AM
  727.  
  728.               Please confirm (Y or N):
  729.  
  730. If an undeleted version of the file already exists in the directory, OzUtil 
  731. allows you to either replace the existing file or type in a new name for the 
  732. restored file.  Should you try to give the file a name that is already used in 
  733. the current directory, OzUtil asks you to try again.
  734.  
  735.  
  736. Other OzUtil Features
  737. ----- ------ --------
  738. Demonstrate Oz - This is a simulation that demonstrates the protection functions 
  739. of OzRes, the resident portion of Oz.  It operates only when OzRes is loaded.
  740.  
  741.      Note:  This is not a disabled demo.  The functions of OzRes
  742.      will actually work within it.
  743.  
  744. Information About Oz - This function displays the Oz logo and identifies those 
  745. responsible for the program.
  746.  
  747. Purging Oz-Protected Files - This option permanently erases a specified level of 
  748. Oz-protected files, allowing you to reuse their disk space.  When you choose the 
  749. Purge option, OzUtil will prompt you for the number of generations you wish to 
  750. keep:
  751.  
  752.         How many generations of Oz-protected files should be preserved by 
  753.         this purging?  Enter 0 - 7 (or <Esc> to quit):
  754.  
  755. After you choose the number of generations to preserve, OzUtil searches all 
  756. directories on the current drive and deletes all Oz-protected files with version 
  757. numbers greater than your choice.
  758.  
  759. Note that there is very rarely any need to use the purge option.  In fact 
  760. purging files wastes disk space.  Generally you are better off letting your disk 
  761. fill up and leaving it to OzRes to handle disk-full conditions.  One time that 
  762. you may benefit by purging some older Oz-deleted files is prior to defragmenting 
  763. a disk.
  764.  
  765. Toggle Write-Protection - As described in Chapter 1, OzRes automatically 
  766. protects your selected disks against format attempts by "write-protecting" them.  
  767. When this happens, files cannot be created, modified, or deleted.
  768.  
  769. The Toggle Write-Protection option allows you to turn write-protection off after 
  770. an attempt to reformat the disk - or turn it on in case you wish to test unknown 
  771. software that may contain a Virus or Trojan Horse.
  772.  
  773. When disks are write-protected, OzUtil displays in the status line near the top 
  774. of the screen:
  775.  
  776.               OzRes has write-protected your hard drives
  777.  
  778. A critical error message will appear if you attempt to write to a write- 
  779. protected disk (see Chapter 6).
  780.  
  781. Unload OzRes from Memory - This option removes OzRes, the terminate and stay 
  782. resident (TSR) portion of Oz, from your computer's memory. 
  783.  
  784. There are three common reasons for removing OzRes from memory:
  785.  
  786. To reclaim the memory used by OzRes, about 14K. To reload OzRes with a different 
  787. command line.  And to deliberately reformat your hard disk.
  788.  
  789. The effect of unloading OzRes is immediate and you are returned to a simplified 
  790. menu.
  791.  
  792.  
  793. Quit - This option, or [Esc], terminates OzUtil.
  794.  
  795.                            Chapter 5
  796.                      When Your Disk Fills Up
  797.                      ==== ==== ==== ===== ==
  798.  
  799. Oz-deleted files can consume a lot of disk space, and may eventually fill the 
  800. disk with older generations of files that you no longer need. 
  801.  
  802. When the free space on your disk is exhausted, OzRes allows you to reclaim disk 
  803. space even in the middle of an application - without losing your work or 
  804. crashing the system - by popping up with a menu of options.
  805.  
  806.  
  807. Before Reading this Chapter:  Bringing Up OzRes
  808. ------ ------- ---- --------  -------- -- -----
  809. A common procedure when reading a software manual is to simultaneously operate 
  810. the program's features. 
  811.  
  812. With OzRes, this requires some preparation.  Most TSR (terminate and stay 
  813. resident) programs "pop up" in response to a "hotkey" signal from the keyboard, 
  814. such as a combination of [Alt] and [Enter].
  815.  
  816. OzRes does not work this way - it normally appears only in response to an error 
  817. condition in the system.  If you wish OzRes to appear in order to accompany the 
  818. test of this chapter, then start OzUtil and run the demo.
  819.  
  820.  
  821. If Your Disk is Full...
  822. -- ---- ---- -- -------
  823. When OzRes detects that there is not enough space on an Oz-protected disk to 
  824. complete a disk write, it displays a dialog box on your screen:
  825.  
  826.                ╔═ An Ounce Of Prevention ══════════════════╗
  827.                ║                                           ║
  828.                ║ Your disk C: is full.                     ║
  829.                ║                                           ║
  830.                ║ You may:  Continue  Purge  Move  Delete   ║
  831.                ║      Return to application                ║
  832.                ╚═══════════════════════════════════════════╝
  833.  
  834. This dialog box offers four choices along with short explanations of their 
  835. functions.  To use any of the options:
  836.  
  837.      Press the capitalized letter of the option, or
  838.      Move the cursor bar to the desired option and press [Enter]
  839.  
  840.  
  841. Continue
  842. --------
  843. Selecting the Continue option causes OzRes to take no action whatsoever, but 
  844. returns the error condition to the application program.  You must then rely on 
  845. the application itself to handle the disk-full error.  Some applications do not 
  846. do a good job of this.  A few, in fact, fall flat on their faces.
  847.  
  848.  
  849. Purge
  850. -----
  851. This option is similar to the Purge function of OzUtil.  It searches the disk 
  852. for older generations of Oz-deleted files in order to free disk space.
  853.  
  854. When you select the Purge option, OzRes tells you how many generations of Oz- 
  855. deleted files are being kept, and prompts you for the number of generations that 
  856. you wish to keep:
  857.  
  858.               ╔═ An Ounce Of Prevention ══════════════════╗
  859.               ║                                           ║
  860.               ║ Oz is maintaining 7 generations of        ║
  861.               ║ deleted files.  How many generations      ║
  862.               ║ do you want to keep (0 - 6)?              ║
  863.               ╚═══════════════════════════════════════════╝
  864.  
  865.      Press the desired number and [Enter].
  866.  
  867. OzRes searches all directories on the protected disk and permanently deletes any 
  868. Oz-protected files of generations earlier than the specified number.  OzRes 
  869. keeps you informed of its progress by providing a line that displays:
  870.  
  871.               Scanning directory:  (path name)
  872.  
  873. OzRes quickly displays the names of files that it purges from disk.  When it is 
  874. finished, Oz either states the number of bytes reclaimed...
  875.  
  876.               Diskspace freed: x bytes
  877.  
  878. Or announces...
  879.  
  880.               No space reclaimed
  881.  
  882.               Press any key to continue.
  883.  
  884. DOS will again attempt to write to the disk.  If there is still insufficient 
  885. space, the "disk full" dialog box reappears.
  886.  
  887.  
  888. Moving Files
  889. ------ -----
  890. The Move option frees disk space by "moving" selected files to another disk.  
  891. OzRes copies the files that you select to that disk, then deletes them from the 
  892. Oz-protected disk.
  893.  
  894.      Note:  Unlike the commonly used "move" function of DOS shell
  895.      programs, this option does not merely switch files from one
  896.      directory to another but copies from one physical drive to
  897.      another, then deletes the original.
  898.  
  899. Choose the Move option on the dialog box.
  900.  
  901. OzRes displays another box:
  902.  
  903. ┌────────────────────────────────────────────────────────────────────────────┐
  904. │                                                                            │
  905. │ Ready to move files to another disk.                                       │
  906. │                                                                            │
  907. │ Target disk [A-E]:                                                         │
  908. │                                                                            │
  909. │ Use:  <Esc> to return to menu.  <F1> to change directory.                  │
  910. │       <Home>, <PgDn>, and <PgUp> to scroll the directory listing.          │
  911. │                                                                            │
  912. └────────────────────────────────────────────────────────────────────────────┘
  913.  
  914.      Press a letter from "A" to "E" to choose the target disk to
  915.      which the files are to be moved, for example "A".
  916.  
  917. The message on "Oz" line in the dialog box will read:
  918.  
  919.               Ready to move files to A:
  920.  
  921. You will be asked to provide the name of a file to be moved at the line "Enter 
  922. filename:'
  923.  
  924. ┌────────────────────────────────────────────────────────────────────────────┐
  925. │                                                                            │
  926. │ Ready to move files to A:                                                  │
  927. │                                                                            │
  928. │ Enter filename:                                                            │
  929. │                                                                            │
  930. │ Use:  <Esc> to return to menu.  <F1> to change directory.                  │
  931. │       <Home>, <PgDn>, and <PgUp> to scroll the directory listing.          │
  932. │                                                                            │
  933. │ Current directory:  C:\STUFF                                               │
  934. │  COLDBOOT.COM   WARMBOOT.COM   CP.EXE         LS.EXE         RM.EXE        │
  935. │  STRINGS.EXE    SIZE.EXE       MV.EXE         BEEP.COM       CLEAN.EXE     │
  936. │  DUP.EXE        CLOD.EXE       CMOSGET.COM    CMOSPUT.COM    COMMODE.EXE   │
  937. │  DF.EXE         DVICEMAP.COM   DVICEMAP.DOC   FC.EXE         MAPMEM.COM    │
  938. │  MEMTEST.EXE    PKARC.COM      PKXARC.COM     SCRSAVE.EXE    SNAP.COM      │
  939. │  TOUCH.EXE      CORTST26.DOC   CORTST27.EXE   WSN.EXE        WFIX.EXE      │
  940. └────────────────────────────────────────────────────────────────────────────┘
  941.  
  942. At the bottom of the box is a listing of files in the current directory.  The 
  943. following keys help you navigate through this display:
  944.  
  945.      [Esc]    return to the OzRes menu without effect
  946.      [F1]     change current directory
  947.      [PgDn]   scroll down the directory listing
  948.      [PgUp]   scroll up the directory listing
  949.      [Home]   beginning of the directory listing 
  950.      [End]    the end of the directory listing
  951.  
  952. When you are ready to move a file, enter the filename at the prompt.  If OzRes 
  953. is able to copy the file to the new disk, it displays:
  954.  
  955.               Copying:  filename
  956.  
  957. After it is finished copying, OzRes checks to see that the file was moved 
  958. correctly and displays:
  959.  
  960.               Verifying:  filename
  961.  
  962. After the copy is verified, OzRes erases the file on the Oz-protected disk, 
  963. updates the directory list in the dialog box, and displays the total number of 
  964. bytes available on the protected disk: 
  965.  
  966.               Freespace on disk is N bytes
  967.  
  968.      Note:  Files are moved to a directory called "\OZ".
  969.      This directory is created on the target disk if it does
  970.      not already exist.
  971.  
  972. Changing to a New Directory - if you wish to display a new directory on the 
  973. OzRes Move screen:
  974.  
  975.      Press [F1] 
  976.  
  977. The dialog box will prompt you for a new directory path.  
  978.  
  979.      Enter the full pathname, always preceded by a "\".
  980.  
  981. The files in the new directory are displayed at the bottom of the screen.  If, 
  982. however, you enter an incorrect path name, OzRes "beeps" and displays the 
  983. message:
  984.  
  985.               Path not found.  Press any key to continue.
  986.  
  987. You are then prompted to enter another path name.  
  988.  
  989.      Important Note:  NEVER move or delete a file that is in
  990.      use - such as that containing a document you are currently
  991.      working on - even if it appears in the file list!  This may
  992.      prove disastrous when your application needs to write to it again.
  993.  
  994.  
  995. Delete
  996. ------
  997. If you choose to delete files to free disk space, Oz displays a dialog box 
  998. listing the files on the current directory:
  999.  
  1000. ┌────────────────────────────────────────────────────────────────────────────┐
  1001. │                                                                            │
  1002. │ Ready to delete files.  (These files will be truly deleted.)               │
  1003. │                                                                            │
  1004. │ Enter filename:                                                            │
  1005. │                                                                            │
  1006. │ Use:  <Esc> to return to menu.  <F1> to change directory.                  │
  1007. │       <Home>, <PgDn>, and <PgUp> to scroll the directory listing.          │
  1008. │                                                                            │
  1009. │ Current directory:  C:\STUFF                                               │
  1010. │  COLDBOOT.COM   WARMBOOT.COM   CP.EXE         LS.EXE         RM.EXE        │
  1011. │  STRINGS.EXE    SIZE.EXE       MV.EXE         BEEP.COM       CLEAN.EXE     │
  1012. │  DUP.EXE        CLOD.EXE       CMOSGET.COM    CMOSPUT.COM    COMMODE.EXE   │
  1013. │  DF.EXE         DVICEMAP.COM   DVICEMAP.DOC   FC.EXE         MAPMEM.COM    │
  1014. │  MEMTEST.EXE    PKARC.COM      PKXARC.COM     SCRSAVE.EXE    SNAP.COM      │
  1015. │  TOUCH.EXE      CORTST26.DOC   CORTST27.EXE   WSN.EXE        WFIX.EXE      │
  1016. └────────────────────────────────────────────────────────────────────────────┘
  1017.  
  1018. The following keys command keys work exactly as they do in the Move command:
  1019.  
  1020.      [Esc]    return to the OzRes menu without effect
  1021.      [F1]     change current directory
  1022.      [PgDn]   scroll down the directory listing
  1023.      [PgUp]   scroll up the directory listing
  1024.      [Home]   beginning of the directory listing 
  1025.      [End]    the end of the directory listing
  1026.  
  1027. When you are ready to delete a file:
  1028.  
  1029.      Enter the filename at the prompt.
  1030.  
  1031. OzUtil displays the message:
  1032.  
  1033.               Deleting:  filename
  1034.  
  1035.      Note:  Again, make sure you do not delete something you
  1036.      need, especially a file that the current program is using.  
  1037.  
  1038.  
  1039. If Your Disk is Still Full...
  1040. -- ---- ---- -- ----- -------
  1041. If you do not reclaim any space by Moving or Deleting files, the disk-full 
  1042. condition persists and the dialog box returns, displaying:
  1043.  
  1044.               Your disk X: is still full.  
  1045.  
  1046. If you Move or Delete files, but do not reclaim enough space, DOS returns 
  1047. another disk full error and the first OzRes dialog box returns.
  1048.  
  1049. Try Moving or Deleting more files.  If enough space is freed, the OzRes dialog 
  1050. box does not return and you can proceed with your work.
  1051.  
  1052.                               Chapter 6
  1053.                       Handling DOS Critical Errors
  1054.                       ======== === ======== ======
  1055.  
  1056.  
  1057. What are Critical Errors?
  1058. ---- --- -------- -------
  1059. Critical Errors, usually failures to read or write a disk, prevent DOS from 
  1060. continuing a disk operation.  DOS tries to overcome the error by retrying the 
  1061. operation several times. 
  1062.  
  1063. If it is still unsuccessful, DOS may interrupt your work with a cryptic message, 
  1064. for example:
  1065.  
  1066.               Not ready error reading drive A:
  1067.               Abort, Retry or Ignore?
  1068.  
  1069. Unless your current application intercepts these errors and handles them 
  1070. internally, and many do not, your work is interrupted and the screen display may 
  1071. be corrupted.
  1072.  
  1073. Oz suppresses these messages and instead produces a dialog box on the screen 
  1074. that offers a detailed explanation of what is failing and what you can do about 
  1075. it.
  1076.  
  1077.               ╔═══════════ An Ounce Of Prevention ═══════════════╗
  1078.               ║                                                  ║
  1079.               ║ An error has been detected on disk A:            ║
  1080.               ║ Cause: Attempt to write on write-protected disk  ║
  1081.               ║ Operation: Write to  a directory                 ║
  1082.               ║ Head: 1  Cylinder: 0   Sector: 2                 ║
  1083.               ║                                                  ║
  1084.               ║ You may:  Ignore Retry Abort Fail                ║
  1085.               ║      Ignore the error and continue               ║
  1086.               ╚══════════════════════════════════════════════════╝
  1087.  
  1088. This dialog box contains more information than DOS provides and, unlike other Oz 
  1089. features, operates for all drives.  However, this feature operates only when you 
  1090. are running text-mode (as opposed to graphics) programs.
  1091.  
  1092. The Critical Error dialogue box contains the following information displayed on 
  1093. different lines:
  1094.  
  1095.  
  1096. Cause
  1097. -----
  1098. The Cause describes the critical error detected by DOS.  In the previous 
  1099. example, OzRes reported the following:
  1100.  
  1101.               Cause: Attempt to write on write-protected disk
  1102.  
  1103.  
  1104. Operation
  1105. ---------
  1106. This is the DOS "operation" - disk read or write - when the error occurred, for 
  1107. example:
  1108.  
  1109.               Operation: Write to a directory
  1110.  
  1111. The Operation tells you:
  1112.  
  1113.      Which operation failed, a read or a write.
  1114.  
  1115.      Where the operation failed - DOS area, File Allocation
  1116.      Table, a directory, or a file.
  1117.  
  1118. This information can help you determine which file or directory is having 
  1119. trouble.
  1120.  
  1121.  
  1122. Head, Cylinder and Sector
  1123. ----- -------- --- ------
  1124. The fields on this line can tell advanced users the physical location of the 
  1125. problem on the disk:
  1126.  
  1127.               Head: 1  Cylinder: 0   Sector: 2
  1128.  
  1129. This information can be used to identify bad spots on the disk that can then be 
  1130. marked as unusable.
  1131.  
  1132.  
  1133. Choices
  1134. -------
  1135. At the bottom of the dialog box is a menu of four choices:
  1136.  
  1137. Ignore - This option tells DOS to ignore the error, allowing the application to 
  1138. continue operating.  Choose this option only when you know the cause of the 
  1139. error, and are sure that it is harmless. 
  1140.  
  1141. You might choose "Ignore" if part of a document that you are trying to read into 
  1142. a word processor resides on a bad sector.  DOS will continue reading the disk, 
  1143. allowing you to later excise the bad portion of the document.
  1144.  
  1145. Retry -  This option retries the disk operation that failed.  While DOS itself 
  1146. retries disk operations several times before reporting an error, you may be able 
  1147. to correct some errors by yourself.
  1148.  
  1149. For example, the "Drive Not Ready" error message is intended to be a "pause" 
  1150. that allows you to insert a floppy disk into a drive or close the drive door.  A 
  1151. "Read Fault" error allows you to give a fickle floppy disk just one more chance.
  1152.  
  1153. Abort - This option kills the current program, a safe bet if you can stand to 
  1154. lose the work done since the last save. 
  1155.  
  1156. Fail - This is option returns the error condition to the program.  Fail is a 
  1157. good choice only if the application gracefully handles the error condition 
  1158. itself. 
  1159.  
  1160. If it won't, use Abort.
  1161.  
  1162.                               Appendix A
  1163.                          OzRes Error Messages
  1164.                          ===== ===== ========
  1165.  
  1166.  
  1167. If OzRes fails on start-up due to a DOS, system, or command-line error, it 
  1168. terminates with the message:
  1169.  
  1170.               OzRes initialization error:
  1171.  
  1172. immediately followed by an explanation the nature of the problem.
  1173.  
  1174. The following are the known problems that might cause a OzRes initialization 
  1175. failure, and possible solutions to each of them:
  1176.  
  1177.  
  1178. Drive is Incompatible or Faulty - OzRes has been asked to protect a non-existing 
  1179. or unsuitable disk, such as a network drive or a drive that has a nonstandard 
  1180. driver.
  1181.  
  1182. Drive does not exist - You have specified a letter that does not identify a disk 
  1183. volume.
  1184.  
  1185. Drive has an unacceptable sector size - All standard DOS drives are formatted 
  1186. with 512-byte sectors.  OzRes refuses to handle a drive with a different sector 
  1187. size.
  1188.  
  1189. Drive is an ASSIGNed, SUBSTituted or Network Drive - OzRes does not protect 
  1190. drives that are identified indirectly via the DOS ASSIGN or SUBST commands, nor 
  1191. network drives.
  1192.  
  1193. Drive is not a Hard Drive - OzRes does not protect floppy drives or RAM disks.
  1194.  
  1195. Drive is not a Valid Partition - You have a hard drive that is partitioned in 
  1196. some non-standard manner that OzRes cannot understand.
  1197.  
  1198. DOS Incompatibility - You are running a nonstandard version of DOS that OzRes 
  1199. does not recognize, such as the private-label "Falcon-DOS".  You must switch to 
  1200. a standard variety of DOS, such as MS-DOS, PC-DOS, or possibly, DR-DOS.
  1201.  
  1202. Duplicate Disk Specification - You  have entered a command line containing a 
  1203. repeated disk letter, such as:
  1204.  
  1205.               ozres cdc:
  1206.  
  1207. Invalid Argument - You have attempted to load OzRes with an invalid command-line 
  1208. argument.  Please check Chapter 3 for the proper syntax of a OzRes command line.
  1209.  
  1210. Invalid Command Line Option - You have attempted to load OzRes with an invalid 
  1211. Program Option following a slash.  The only valid Program Options are "A", for 
  1212. the archive feature, and "n", where "n" is the number of generations to be 
  1213. preserved.
  1214.  
  1215. Invalid Disk Specification - OzRes is unable to understand the drive name that 
  1216. you have specified.  You may, for example, have specified an invalid drive name, 
  1217. such as "3:".
  1218.  
  1219. No Disk Specified on Command Line - OzRes will not continue unless you provide a 
  1220. drive for it to protect, usually "C:" drive.
  1221.  
  1222. Program is Already Loaded - You may have only one active copy of OzRes.  If you 
  1223. load another, OzRes will detect the presence of the first copy and refuse to 
  1224. continue.  If it is important to protect a disk other than the currently 
  1225. protected one, you should first unload OzRes with OzUtil.
  1226.  
  1227. Runs Only With DOS Version 3, 4, or 5 - OzRes will not run under either DOS 1, 2 
  1228. or the OS/2 compatibility box.
  1229.  
  1230.                              Appendix B
  1231.                           Technical Notes
  1232.                           --------- -----
  1233.  
  1234.  
  1235. How Oz Preserves Deleted Files
  1236. --- -- --------- ------- -----
  1237. When a request is made to delete a file, OzRes intercepts that request before 
  1238. DOS can process it.  OzRes then checks the following criteria to decide if it 
  1239. should preserve the file:
  1240.  
  1241. 1.   Is the file on the volume that Oz is protecting?
  1242. 2.   Has the file been backed-up in its current form?
  1243. 3.   Is the file excluded from preservation by virtue of having a name that 
  1244.      matches one of the exclusion patterns given to Oz at startup?
  1245. 4.   Is the filename free of "weird" characters?  (See the section on Odd 
  1246.      Filenames below.)
  1247.  
  1248. If the answer to any of these questions is no, then OzRes passes on the request 
  1249. to DOS which performs the deletion in its normal way.  If the answer to every 
  1250. question is yes, then Oz handles the deletion by taking the following actions:
  1251.  
  1252. 1.   Oz flags the file as hidden.
  1253. 2.   Oz searches for older generations of the same file.  If it finds any, it 
  1254.      reassigns generation numbers to make room for the new generation.
  1255. 3.   If a file is found whose generation number is the the highest that OzRes 
  1256.      has been told to preserve, it is discarded.
  1257. 4.   Oz encodes the file's name to preserve the generation number.
  1258.  
  1259. Oz does not move files to another directory, but renders them invisible while 
  1260. leaving them in the same directory.
  1261.  
  1262.  
  1263. Using File Shell Programs on Oz-Protected Volumes
  1264. ----- ---- ----- -------- -- ------------ -------
  1265. Some utilities such as XTREE and the Norton Utilities' FA can "see" Oz-deleted 
  1266. files.  Should you use such a utility you can always spot a Oz-deleted file 
  1267. because its name starts with the character Pi (π).  DOS will not erase Oz- 
  1268. deleted files because they have the "hidden" attribute set.
  1269.  
  1270. You may find that a file utility such as XTREE can copy a Oz-deleted file, but 
  1271. the copy will also be hidden unless you change its attributes.
  1272.  
  1273. It is always wise to leave Oz-protected files alone!
  1274.  
  1275.  
  1276. Odd Filenames
  1277. --- ---------
  1278. Oz preserves only those files that have names composed of keyboard characters 
  1279. (including those on foreign keyboards).  DOS allows you to use strange 
  1280. characters, such as graphics characters, in filenames, but Oz will not preserve 
  1281. files with such names.
  1282.  
  1283. As mentioned above, Oz uses one special character when naming its files. That 
  1284. character is the Greek letter Pi (π) which has the value 227 (E3 hex).  
  1285. Preserved files are maintained in their native directories as "hidden" files 
  1286. whose names start with Pi.  Oz may not work reliably if any other software is 
  1287. creating files with names starting with this character.
  1288.  
  1289. Upon preserving a file, Oz clears the file's archive attribute.  When Oz 
  1290. restores a preserved file, it sets the archive attribute.  This means that a Oz- 
  1291. protected file will not be considered a candidate for backup by those backup 
  1292. programs that key on the archive attribute.  If your backup program keys by date 
  1293. and time, or backs up all file no matter what, then it will dutifully backup Oz- 
  1294. protected files.
  1295.  
  1296.  
  1297. Files that Oz Won't Delete
  1298. ----- ---- -- ----- ------
  1299. Oz does not try to delete files that DOS would not delete.  These include files 
  1300. with the read-only attribute set.  In such a case, Oz returns the same error 
  1301. code to your program that DOS would.
  1302.  
  1303.                               Appendix C
  1304.                                Support
  1305.                                -------
  1306.  
  1307. This product is backed by a business that has been in full-time operation since 
  1308. 1983.  It is our wish and intention to provide the best user support that we 
  1309. can.  We are, nevertheless, a small operation and are unable to offer call-in 
  1310. telephone support.  We do offer support by mail, fax and electronic mail.
  1311.  
  1312. By Mail:  Please direct letters to our regular address:
  1313.  
  1314.               Pete Maclean Software
  1315.               P. O. Box 591359
  1316.               San Francisco,  CA 94159-1359
  1317.  
  1318. By Fax:  Please send facsimiles to +1 415-751-4635.
  1319.  
  1320. By Email:  Please direct electronic mail to id [75776,660] on CompuServe.  
  1321. Note that email will be forwarded to CompuServe by MCI Mail and certain other 
  1322. public mail systems.  From MCI Mail use the following address:
  1323.  
  1324.               To:  Pete Maclean Software
  1325.                    EMS: COMPUSERVE
  1326.                    MBX: 75776.660
  1327.  
  1328.  
  1329.                               Appendix D
  1330.                               Shareware
  1331.                               ---------
  1332.  
  1333. Shareware is a distribution method for commercial software that gives you a 
  1334. chance to try a product before you buy it.
  1335.  
  1336. If you try a Shareware program and continue using it, you are expected to 
  1337. register.  Details differ -- some Shareware publishers request registration 
  1338. while others require it; some specify a maximum trial period.  With 
  1339. registration, you get anything from the simple right to continue using the 
  1340. software to an updated program with printed manual.
  1341.  
  1342. Copyright laws apply to Shareware, as to any other commercial software, and the 
  1343. copyright holder retains all rights, with a few specific exceptions as stated 
  1344. below.  Shareware authors are accomplished programmers and the programs are of 
  1345. comparable quality to retail products.  (In both cases, there are good programs 
  1346. and bad ones!)  The main difference is in the method of distribution.  The 
  1347. Shareware publisher specifically grants the right to copy and distribute the 
  1348. software, either to all and sundry or to a specific group.  For example, some 
  1349. publishers require written permission before a commercial disk vendor may copy 
  1350. their Shareware.
  1351.  
  1352. Shareware, then, is a distribution method not a type of software.  You should 
  1353. find software that suits your needs and pocketbook, whether it's retail or 
  1354. Shareware.  The Shareware system makes fitting your needs easier, because you 
  1355. can try before you buy.  And because the overhead is low, prices are low also. 
  1356. Shareware has the ultimate money-back guarantee -- if you don't use the product, 
  1357. you don't pay for it.
  1358.  
  1359. This program is produced by a member of the Association of Shareware 
  1360. Professionals (ASP).  ASP wants to make sure that the shareware principle works 
  1361. for you.  If you are unable to resolve a shareware-related problem with an ASP 
  1362. member by contacting the member directly, ASP may be able to help.  The ASP 
  1363. Ombudsman can help you resolve a dispute or problem with an ASP member, but does 
  1364. not provide technical support for members' products.
  1365.  
  1366. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send 
  1367. a Compuserve message via easyplex to ASP Ombudsman 70007,3536.  The OMB may be 
  1368. contacted by FAX by sending to the ASP FAX number: (616) 788-2765. In 
  1369. communication with the OMB please include a telephone number and/or FAX if 
  1370. available."
  1371.                            ┌─────────┐
  1372.                      ┌─────┴───┐     │               (R)
  1373.                    ──│         │o    │──────────────────
  1374.                      │   ┌─────┴╨──┐ │  Association of
  1375.                      │   │         │─┘  Shareware
  1376.                      └───│    o    │    Professionals
  1377.                    ──────│    ║    │────────────────────
  1378.                          └────╨────┘    MEMBER
  1379.  
  1380.